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Abstract 


The PIM version 2 messages share a common message header format. The common header 
definition contains eight reserved bits. This document specifies how these bits may be used by 
individual message types and creates a registry containing the per-message-type usage. This 
document also extends the PIM type space by defining three new message types. For each of the 
new types, four of the previously reserved bits are used to form an extended type range. 


This document updates RFCs 7761 and 3973 by defining the use of the currently Reserved field in 
the PIM common header. This document further updates RFCs 7761 and 3973, along with RFCs 
5015, 5059, 6754, and 8364, by specifying the use of the currently reserved bits for each PIM 
message. 


This document obsoletes RFC 6166. 


Status of This Memo 


This is an Internet Standards Track document. 


This document is a product of the Internet Engineering Task Force (IETF). It represents the 
consensus of the IETF community. It has received public review and has been approved for 
publication by the Internet Engineering Steering Group (IESG). Further information on Internet 
Standards is available in Section 2 of RFC 7841. 


Information about the current status of this document, any errata, and how to provide feedback 
on it may be obtained at https://www.rfc-editor.org/info/rfc8736. 
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Copyright Notice 


Copyright (c) 2020 IETF Trust and the persons identified as the document authors. All rights 
reserved. 


This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF 
Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this 
document. Please review these documents carefully, as they describe your rights and restrictions 
with respect to this document. Code Components extracted from this document must include 
Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are 
provided without warranty as described in the Simplified BSD License. 
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1. Introduction 


February 2020 


The PIM version 2 messages share a common message header format defined in the PIM Sparse 
Mode specification [RFC7761]. The common header definition contains eight reserved bits. While 
all message types use this common header, there is no document formally specifying that these 
bits are to be used per message type. 


This document refers to the bits specified as "reserved" in the common PIM header [RFC7761] as 
"PIM message type Flag Bits" or, simply, "Flag Bits", and it specifies that they are to be separately 
used on a per-message-type basis. It creates a registry containing the per-message-type usage. 


This document updates [RFC7761] and [RFC3973] by defining the use of the currently Reserved 
field in the PIM common header. This document further updates [RFC7761] and [RFC3973], along 
with [RFC5015], [RFC5059], [RFC6754], and [RFC8364], by specifying the use of the currently 
reserved bits for each PIM message. 
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The currently defined PIM message types are in the range from 0 to 15. That type space is almost 
exhausted. Message type 15 was reserved by [RFC6166] for type space extension. In Section 5, 
this document specifies the use of the Flag Bits for message types 13, 14, and 15 in order to 
extend the PIM type space. This document obsoletes [RFC6166]. 


2. Conventions Used in This Document 


The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD 
NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to 
be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in 
all capitals, as shown here. 


3. PIM Header Common Format 


The common PIM header is defined in Section 4.9 of [RFC7761]. This document updates the 
definition of the Reserved field and refers to that field as "PIM message type Flag Bits" or, simply, 
"Flag Bits". The new common header format is as below. 


(0) al 2 B 

G aTa e a E e a e O a a e S a T a S 2 S A O T a S al 
tot-4-4-4+-4-4-4-4-4-4-4-4+-4-4-4-4t-4-4-4-4F-4-4-4-4-4-4-4-4-4-4-4-4 
|PIM Ver| Type | Flag Bits Checksum 
+-+-+-+-+-+-+-+-+-+-+-+-+-+ tito t ita titi t ata titi HHHH 


Figure 1: New Common Header 


The Flag Bits field is defined in Section 4. All other fields remain unchanged. 


4. Flag Bit Definitions 


Unless otherwise specified, all the flag bits for each PIM type are Reserved [RFC8126]. They MUST 
be set to zero on transmission, and they MUST be ignored upon receipt. The specification of a 
new PIM type MUST indicate whether the bits should be treated differently. 


When defining flag bits, it is helpful to have a well-defined way of referring to a particular bit. 
The most significant of the flag bits, the bit immediately following the Type field, is referred to as 
bit 7. The least significant, the bit right in front of the Checksum field, is referred to as bit 0. This 
is shown in the diagram below. 
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(0) al 2 3 
(Oy A Sh AS S TA sh S O al PE SAS ey T e Yeh T ey A SS e teh) (0) sal 
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+- +H 
|PIM Ver| Type |7 65432 190| Checksum 
+-+-+-+-+-+-+-+-+-+-+-+-+-+ tH 


Figure 2: Flag Bits 


4.1. Flag Bits for Type 4 (Bootstrap) 


PIM message type 4 (Bootstrap) [RFC5059] defines flag bit 7 as No-Forward. The usage of the bit is 
defined in that document. The remaining flag bits are reserved. 


4.2. Flag Bits for Type 10 (DF Election) 


PIM message type 10 (DF Election) [RFC5015] specifies that the four most significant flag bits (bits 
4-7) are to be used as a subtype. The usage of those bits is defined in that document. The 
remaining flag bits are reserved. 


4.3. Flag Bits for Type 12 (PFM) 


PIM message type 12 (PIM Flooding Mechanism) [RFC8364] defines flag bit 7 as No-Forward. The 
usage of the bit is defined in that document. The remaining flag bits are reserved. 


4.4. Flag Bits for Types 13, 14, and 15 (Type Space Extension) 


These types and the corresponding flag bits are defined in Section 5. 


5. PIM Type Space Extension 


This document defines types 13, 14, and 15, such that each of these types has 16 subtypes, 
providing a total of 48 subtypes available for future PIM extensions. This is achieved by defining 
a new Subtype field (see Figure 3) using the four most significant flag bits (bits 4-7). The notation 
type.subtype is used to reference these new extended types. The remaining four flag bits (bits 
0-3) are reserved to be used by each extended type (abbreviated as FB below). 


0 T 2 3 
O Sh an S A R SP (0) al ey ey (oy T e S O a 2 sh Zs) 1s) E E Ea 
Foto t oto toto toto toto titi t ita +H 
|PIM Ver| Type |Subtype| FB l Checksum 
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+H+Ht++HHHHHHHH HHHH 


Figure 3: Subtypes 
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February 2020 


This document clarifies the use of the flag bits in the common PIM header, and it extends the PIM 
type space. As such, there is no impact on security or changes to the considerations in [RFC7761] 


and [RFC3973]. 


7. IANA Considerations 


This document updates the "PIM Message Types" registry to indicate which flag bits are defined 
for use by each of the PIM message types. The registry now references this document. The 
registration policy remains IETF Review [RFC8126]. Assignments into this registry MUST define 
any non-default usage (see Section 4) of the flag bits in addition to the type. 


The updated "PIM Message Types" registry is shown below. 


Type 
0 


10 


11 


12 
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Name 

Hello 
Register 
Register Stop 
Join/Prune 


Bootstrap 


Assert 
Graft 


Graft-Ack 


Candidate RP Advertisement 


State Refresh 


DF Election 


ECMP Redirect 


PIM Flooding Mechanism 


Flag Bits 

0-7: Reserved 
0-7: Reserved 
0-7: Reserved 
0-7: Reserved 


0-6: Reserved 


7: No-Forward 


0-7: Reserved 
0-7: Reserved 
0-7: Reserved 
0-7: Reserved 
0-7: Reserved 
0-3: Reserved 
4-7: Subtype 

0-7: Reserved 


0-6: Reserved 
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Type Name Flag Bits Reference 
7: No-Forward [RFC8364] 


13.0-15.15 Unassigned 0-3: Unassigned RFC 8736 
Table 1: Updated PIM Message Types Registry 


The unassigned types above, as explained in Section 5, use the extended type notation of 
type.subtype. Each extended type only has 4 flag bits available. New extended message types 
should be assigned consecutively, starting with 13.0, then 13.1, etc. 
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